package com.animerank.mapper;

import com.baomidou.mybatisplus.core.mapper.BaseMapper;
import com.animerank.entity.Vote;
import org.apache.ibatis.annotations.Mapper;
import org.apache.ibatis.annotations.Param;

import java.time.LocalDateTime;
import java.util.List;

/**
 * 投票Mapper接口
 */
@Mapper
public interface VoteMapper extends BaseMapper<Vote> {

    /**
     * 检查用户是否已为动漫投票
     * @param userId 用户ID
     * @param animeId 动漫ID
     * @return 投票记录数量
     */
    Integer checkUserVote(@Param("userId") Long userId, @Param("animeId") Long animeId);

    /**
     * 查询用户今日投票次数
     * @param userId 用户ID
     * @param today 今日开始时间
     * @return 投票次数
     */
    Integer countUserTodayVotes(@Param("userId") Long userId, @Param("today") LocalDateTime today);

    /**
     * 查询IP今日投票次数
     * @param ip IP地址
     * @param today 今日开始时间
     * @return 投票次数
     */
    Integer countIpTodayVotes(@Param("ip") String ip, @Param("today") LocalDateTime today);

    /**
     * 查询动漫总票数
     * @param animeId 动漫ID
     * @return 总票数
     */
    Integer countAnimeVotes(@Param("animeId") Long animeId);
    
    /**
     * 查询用户投票历史（分页）
     * @param userId 用户ID
     * @param offset 偏移量
     * @param limit 限制数量
     * @return 投票历史列表
     */
    List<Vote> getUserVotes(@Param("userId") Long userId, @Param("offset") Integer offset, @Param("limit") Integer limit);
    
    /**
     * 统计用户投票总数
     * @param userId 用户ID
     * @return 投票总数
     */
    int countUserVotes(@Param("userId") Long userId);

}